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WARRANTY 
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LIMITATION OF WARRANTY 
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EXCLUSIVE REMEDIES 
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One-line description: 

Passing parameters to command files is inconsistient. 

Problem: 

Parameter passing to the commands file is not consistent. A 

command file will accept parameters as shown in the following 

example: 

prefix_&parm 

but not in the form: 

&parm_suf fix 

The second method will cause a syntax error to be flagged. 

Solution: 

Avoid using parameters shown in the above example. 
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1. The information in this book is complete: 

Doesn't cover enough 
(what more do you need?) 
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2. The information in this book is accurate: 
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3. The information in this book is easy to find: 

I can't find things I need 12 3 4 5 

4. The Index and Table of Contents are useful: 
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5. What about the "how-to" procedures and examples: 
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7. What about organization of the book: 
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Model 64100AF Version 2.00 
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Chapter 1 

GENERAL INFORMATION 



INTRODUCTION 



This manual describes commands available from the system monitor. The first two chapters cover 
general system information and attributes of the file system. Chapter 3 covers all system monitor 
commands and refers user to the separate editor, compiler, assembler/linker, emulation/analysis, 
state, timing and prom programmer manuals for details of their operation. Chapter 4 describes 
procedures for updating software. Appendix A may be used as a quick reference guide for general 
status/error messages associated with the system monitor. 



DISPLAY FORMAT 



The HP 64000 software package is oriented around the use of the development station CRT display 
as the sole system control device. The display is divided into four areas as shown in figure 1-1 . 

The STATUS line displays system status, explanatory messages, error messages and time. For the 
convenience of the operator, a quick reference status/error message summary for the monitor is 
given in Appendix A. For all other status/error messages refer to the appropriate module reference 
manual. 



The command area consists of a line that wraps across three screen lines. Entered commands and 
interrogation responses are displayed in this line. 

A blinking underline cursor is present in the top left-hand corner of the command line (just under the 
status line). The cursor indicates the current character position on the line. 



1-1 



System Software 
Reference Manual 



Data 
Area 



Data area consists of 18 lines of text. It displays 80 columns with 
provisions for 240 columns using the I shim j f — — J 

and [ ■"<'" ] ( — ► J functions. The extended column 
capability permits detailed comments in source code generation 
and 240 character commands in command files. 



Status Line_ 



I 

Command 

Lines 



_XX:XX 
Time 



Command Line 
' blinking cursor 



Softkey Label Line 



Figure 1-1. CRT Display 



DIRECTED SYNTAX SOFTKEYS 



Eight unmarked keys immediately below the CRT are labelled by the softkey label line just below 
the command line. These softkeys (see figure 1-2) indicate the complete set of allowable entries 
and change with each key stroke to reflect the next expected keyword or data in a command. If 
the user enters only that information prompted by the softkeys, the syntax will always be correct. 
Conversely, any entry not shown in the softkey labels will result in a syntactical error. 

Note that the far right hand softkey is labelled / — ETC — /. Pressing this softkey relabels the 
softkeys and presents additional softkey label line choices. Any item displayed on the CRT in all 
upper case and enclosed in angle brackets (<>) provides guidance for user-defined data. Press the 
softkey and information will be displayed on the status line as to requirements or defaults. 



NOTE 

It is also possible to type the commands (in lower-case characters) from 
the keyboard. This provides an alternative to the softkeys for the touch 
typist. 
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edit compile assemble link * promprg run — ETC- 
where * varies with hardware configuration. 



Figure 1-2. First Softkey Display 

To further enhance the use of the system, a uniform syntax/feature set was provided. For example, 
numeric constants may be specified in decimal, hexadecimal, octal, or binary throughout the 
system. 

As each softkey is pressed, the cursor moves to the right providing reference for the inputs. If an 
error is made on the input, the cursor may be backspaced to the point of error. As the cursor 
moves back, the softkey label line information changes presenting the syntax choices available. If 
the cursor is backspaced to one of the key words, the key word may be replaced by pressing 
another softkey. 



NOTE 



A word may be replaced by positioning the cursor anywhere under that 
word and pressing another softkey. No other information in the com- 
mand line is replaced or changed. 



Entering Commands 

System commands are composed of keywords (all lower case) and user-defined data. Softkeys 
are particularly valuable since they reflect all meaningful keywords available in building the com- 
mand as well as prompts for user-defined data. The softkey labels change during the course of 
entering a command to guide the user through the command syntax. 

Command syntax example: 

store all files :all_userids listfile printer 

Once a command has been constructed in this manner, pressing the [return) key causes execu- 
tion to proceed. If a syntax error is encountered, a message is displayed and the cursor moves to 
the point of error. 
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The error may then be corrected, and pressing the [return) key again will execute the command. 
When execution is successful, the cursor will appear left-justified in the command text. 

Re-executing Existing Commands 

After execution of a command, the same command may be re-executed by pressing the [return) 
key. In fact, any time the cursor is in the command line, pressing the [return) key causes execu- 
tion of the command currently appearing on the line. 

Recalling Commands 

As commands are executed, the command is placed in a memory stack. The command(s) can be 
displayed in the command area by pressing the [RECALL] key. The exact number of commands 
that may be recalled is variable. Once a command is recalled to the command line, it may be ex- 
ecuted by pressing the [return) key; or, once a command is recalled, it may be edited by moving 
the cursor to the keyword to be edited. Select another keyword to make the edit. After the edit is 
make, press the [reTOrn) key for execution. 

The RECALL key recalls the most recently executed commands first. To recall the least recently 
executed commands first, hold down the SHIFT key while pressing RECALL. 



Editing Existing Commands 

Following successful execution, as described above, the cursor will be left-justified in the com- 
mand text. At this point, a right cursor move signals the start of an edit of the command text. 
Softkey labels will reflect alternatives to keywords under which the cursor is placed. All keyboard 
edit functions may be used. Pressing the [return) key again executes the edited line. 



NOTE 

If, instead of moving the cursor after execution, a typing key is pressed, 
the line will be cleared and a new command entry begun. 



Example: 

store all files :all userids listfile printer 

Moving the cursor under all files begins the edit. The softkey labels now show: 

[<FILE>] [all J lies 1 [ / / / / / [ J [listfile] [ ] 
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These are all valid alternatives to all files in the original command. Thus, typing filename MYFILE 

changes the command line to: 

store MYFILE ralluserids listfile printer 



and pressing the [return) key causes it to execute. 



NOTE 



This command will not be executed if a tape cartridge or floppy unit is 
not installed. 



Stopping Execution 

The [RESET] key may be used at any time to stop execution of the current task (editor, assembler, 
compiler, etc.) and return control to the system monitor. Resetting the system monitor, in turn, 
reinitializes the system monitor. To avoid accidental reset, the [RESET] key must be pressed twice 
in succession to cause a reset. When [RESET] is pressed the first time, the system will enter a 
"pause" state. No action may be taken except a stop or continue from the paused state. 
Execution continues only after pressing any key (except [RESET]). For example, a listing to the 
data area may be occurring and a line of interest rolls into view. A pause operation will leave the 
line on screen for observation, and the listing will continue when the pause is ended by pressing 
any of the standard keyboard keys. 



COMMAND FILES 



Command files are source files (created in edit mode or by using the log command) consisting of 
valid system commands to be executed in sequence. Command files provide a convenient 
method of passing parameters and a method of structuring a series of commands to be evoked 
with a minimum amount of keystrokes. The commands start in the system monitor and end with 
the last command in the file. 



The commands are all executed conditional upon no syntactical or semantic errors. If syntactical 
errors are encountered during execution, the sequence will abort at that point. In addition to valid 
system commands, a parameter declaration line may optionally precede commands in a command 
file. 
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Command Structure 

Examples 1 through 4 (following) are examples of command files. Example 1 is a command file in 
which system commands are used without passing parameters. Notice that the system commands 
are typed in lower-case letters and the file names are typed to conform to given file names. This 
command file assembles, links, and emulates (with a previous emulation configuration) a new version 
of a program. 

NOTE 

In these examples the command files are generated while in the editor. 

Example 1: 

assemble TRY1 

link PGRMABS 

emulate C8080 load PGRMABS 
where: 

assemble TRY1 - Initiates an assembly of the source file TRY1 . 

link PGRMABS - Initiates linking of linker command file PGRMABS. 

emulate C8080 load PGRMABS - Initiates emulation using emulator 
command file C8080 and loads PGRMABS. 

Parameter Passing 

Example 2 is a command file using parameter passing. Parameters are defined as follows: 

Passed ASCII text "passed" to a corn- 

Parameters mand file. Any continuous set of 

ASCII characters (no spaces may 

be passed). 

Formal Parameters The name by which the command 

file refers to passed parameters. 
These parameters are upper-case 
symbols preceded by an amper- 
sand (&). 

Formal parameters may be used in any system command in place of any ASCII text not containing 
spaces. The ASCII text passed (in a passed parameter) will be directly substituted for the formal pa- 
rameter at the time the command file is executed. This is referred to as CALL BY NAME. 
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Example 2: 

Command File Name CMD2 
PARMS &SOURCE 
assemble &SOURCE 
link PGRMABS 
emulate C8080 load PGRMABS 

where: 



PARMS - Parameter declaration line. It is the start of the formal parameter 

statement. 

&SOURCE - Ampersand designates a formal parameter. Parameter begins with an 

upper-case letter. 

assemble - Designates that the passed parameter be the file name to be as- 

&SOURCE sembled at execution time. 

link PGRMABS - Runs PGRMABS linker command file. 

emulate C8080 load PGRMABS - Initiates emulation using configuration file 

C8080 and loads PGRMABS. 



When CMD2 is typed and the [return] key is pressed, the system will prompt: 

Define parameter &SOURCE: 

The system prompts for the parameters to be passed. Type in the file to be assembled. The 
command file will then run through the emulate command. 

Alternately, the passed parameter may be entered following the command file name. So CMD2 
FILE4 executes the command file with FILE4 substituted for &SOURCE. The space between 
CMD2 and FILE4 is the delimiter. 



Example 3 is an example of passing parameters in an ASCII string. This could be used to edit an 
existing file, changing, for example, the declaration in an assembler source file. 
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Example 3: 

Command File Name CMD3 

PARMS &FILE 

edit &FILE 

replace "8080" with "8085" 

end 
where: 



PARMS &FILE - Formal parameter declaration line. When CMD3 and [return) 
are entered, the system prompts: 

Define parameter &FILE: 

The file to be edited may be entered as the passed parameter. 

If it is desired to pass the replacement for "8080" as a parameter, the command file should be set up 
as follows: 

Command File Name CMD4 

PARMS &FILE &REP1 

edit &FILE 

replace "8080" with "&REP1" 

end 

In this command file, the replacement for "8080" is defined from the keyboard. The system prompts: 

Define parameter &FILE: 

Type in the filename. 

Define parameter &REP1: 

Type in the replacement to 8080 and press Ireturn) . 

The command file will execute, replacing the 8080 with the designated informat 

A command file may call a second command file. For example, the command file CMD4 just created 
may be modified to call command file CMD2. 



1-8 



System Software 
Reference Manual 



Example 4: 

Command File CMD5 

PARMS &FILE &REP1 

edit &FILE 

replace "8080" with "&REP1" 

end 

CMD2 &FILE 
where: 

PARMS &FILE &REP1 - Formal parameter declaration line. When CMD5 and [return] are en- 
tered, the system prompts: 

Define parameter &FILE (&REP1) 

The file to be edited may be entered as the passed parameter. 

Note that command file CMD2 is automatically called by command file CMD5. All formal parameters 
in CMD2 must be entered on the same line at the end of CMD5 where CMD2 was evoked. 



Any number of command files may be chained in this manner; however, they may not be nested. 
That is, when control is transferred from one command file to the next, there is no return to the 
departure point in the original command file. 



Logging Commands 

Rather than typing into command files the commands to be executed, provisions are made whereby 
the log command may be specified. When the log command is used, all valid commands are written 
to a source file. The source file created may be used to reissue the same set of commands or be 
edited to provide a more general purpose command file using parameter passing. 
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Executing Command File Automatically at Power Up (AutoCmd_#) 



Whenever a station is initially powered up or SHIFT RESET is used, the operating system searches for 
a source file named AutoCmd_# in the blank userid. The # sign indicates the HP-IB bus address of 
the station. If the source file is not found, the operating system comes up in the blank userid ready 
for user input. 

If the AutoCmd_# file is found, it is executed as a command file. This is a normal command file in 
every respect. If the command file requires that parameters be passed, a prompt will appear on the 
command line. 

Example: 

userid HF 

assemble TRY1 

link PGRMABS (link_com file) 

emulate C8080 load PGRMABS (absolute file) 

;This autocommand file is AutoCmd_6 

This example illustrates the file AutoCmd_6 (development station at HP-IB bus address 6). At power 
up, the source file TRY1 is assembled. Next, the linking process is initialized using the linker com- 
mand file PGRMABS. In the last step, the emulation session is started using the configuration 
specified by command file C8080, then the absolute file containing the emulation program is loaded. 

Note, AutoCmd_6 is in the blank userid; the files listed in this source file are in userid HF, which is 
the first system command executed. 
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FILE MANAGER OVERVIEW 



FILES 



A file is defined as a group of data stored in an ordered, identifiable way on the system 
storage media. In the 64000, files are identified by four attributes: file name, userid, logical 
unit (LU) number, and file type (e.g., FILE:USERID: 0:source). 

64000 file names are governed by certain conventions. They must start with an upper-case 
alphabetic character (A thru Z). They may consist of a mixture of alphanumeric characters 

(A thru Z, 1 thru and an underscore ( )) after the first letter and are limited to nine 

characters. If the filename is longer than nine characters, it is truncated to the first nine. 

The user ID portion of a file must start with an upper-case alphabetic character and is limited 
to six characters. After the first letter, the other five characters may be alphanumeric. If a 
user ID of more than six characters is entered, it is truncated to six. 

There are a variety of file types (defined below), and each file is automatically assigned a 
type during the specific application in which it is used. 



asmb db 



This file is created by the state analyzer and is a data base 
containing information from a link__sym file and all of its 
component asmb sym files. 



asmb sym 



This assembler symbol file, generated by the assembler or 
compiler, gives the local symbols for each relocatable file 
linked together for use by the emulator. 



absolute 



An absolute file generated by the linker containing absolute 
object code. 



comp db 



This file is created by the linker when requested and is a 

data base containing information from all of the comp sym 

files associated with relocatables in an absolute file. 



comp sym 



This file is created by the compiler when requested and con- 
tains the entire compiler symbol table for use in creating 
comp db. 



data 



No system programs make any assumptions about the con- 
tents of type data files. They may be generated by the user 
using simulated I/O or by specifying this type of file as the 
output file for a user program written in Host Pascal. 
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emul com 



An emulator command file generated in the emulator module. 
This file type includes all the information necessary to in- 
itiate the emulator. 



link com 



link sym 



A linker command file generated by the linker module. This 
file type includes all the information necessary to describe 
the relocation and linking process to the linker. 

This linker symbol file, generated by the linker, gives the 
global symbols used in a specific link operation for use by 
the emulator. 



listing 



A listing file generated to save the output of any command 
having a list file option. 



prom 



reloc 



A file generated by older versions of the prom programmer. 
This type of file is no longer produced (see Prom 
Programmer Manual). 

A relocatable file generated by either the assembler or com- 
piler containing relocatable object code. 



source 



A file generated by the editor. 



system 



This file appears under userid HP and identifies files contain- 
ing system software. These file names are lower case and 
cannot be accessed or modified by the user. 



trace 



This file is created by some emulators and state/timing 
analyzers for saving results and specifications from 
analysis. 



A given series of files may all have the same name but each file must be a different type. A 
given series of files may have the same name and type but reside on different bus discs. 

Each file has a modified and accessed date placed on it by the file manager. This 
categorizes files for ease in backup. The date&time command should be used at power up so 
that these file dates are at the actual date and time. 



FILE MANAGER 



The file manager (a module of the operating system) is responsible for the organization and 
control of files. File management functions such as purge, recover, and rename are ac- 
complished by the file manager. 

As files are accessed (viewed) or modified on the 64000, the file manager automatically cor- 
rects the modified and accessed dates. For dates to be valid, the date&time command must 
be used correctly. 
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Unique to the 64000 is the ability to recover purged files. The recoverable files directory 
limits the maximum number of recoverable files to 127 on a hard disc and 63 on a floppy disc. 
When a file is purged, its space is linked to the available disc space. As more disc space is 
needed, the purged file will eventually be written over. Also, if the space reserved for a 
recoverable file is needed for an active file, the number of recoverable files will be reduced. 
The purge operation works on a first-in, first-written-over basis. 



When a file is purged, its disc space is linked to the available disc space and deleted from the 
active file disc space. A recoverable directory entry will be made (this also allows a direc- 
tory of all available recoverable files). The direction of disc space use is such that all avail- 
able unwritten space is used before the purged files are written over. On the recover com- 
mand, the purged file is linked to the used disc space and that file's entry is removed from the 
recoverable directory. 



Each time a file is edited, the previous version is also put in the recoverable file list. It is 
therefore possible to recover all versions of a file that have not been written over. Since 
each recoverable file has a last access/modified date, the proper version may be quickly 
selected. 



File Security 



The user may protect his files by assigning a userid password to the files. Protected userids 
are not accessible from any other userid. Although protected userid files will be displayed 

with other files in a directory command, they will only be displayed with "all userid" 

specifiers. The files can only be accessed after the default userid has been set to the 
protected userid. Once entered, the password on the protected userid cannot be later iden- 
tified. It may be changed, however, while operating under the protected userid by reentering 
the userid command. 



The 64000 operating system allows the designated system manager to list the passwords of 
all userids on the system by using a system file called PASGWORDS:pMgR. The protected 
userid MgR is intended to be the system manager's userid. Immediately after booting the 
operating system, the system manager should enter the monitor and assign a password by 
typing: 



userid MgR password X 
where X is the password of the manager's choice. 



From userid "pMgR", the system manager may now enter the special command "prog 
PASSWORDS" and a listing of all protected userids on the system disc together with their 
passwords, will be printed to the printer, if any, or displayed, if no printer is found. 
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NOTE 

Passwords may contain control characters, so the printer 
should be set to "display functions" or, the printer may be 
removed from the system and the control characters will be 
shown on the display. 



The system manager should take care to remember the password on userid "pMgR" as that 
will always be necessary to get into the system manager's userid to issue the special com- 
mand which lists all passwords. 

Page Structure 

The file management system has a linked list structure. Each of the files consists of a block 
of sectors referred to as pages. The number of factors per page is constant for a given 
storage media but may vary to optimize certain file management operations. The pages of a 
file are linked in both toward and backward directions. 

While a file is being updated the same sectors on the storage media are used. If the size of 
the file is increased, the file manager allocates another page to the file, linking it to the end of 
the last page. 

Directory Format 

The 64000 contains a directory which is organized as a hash coded list. Hash coding mini- 
mizes the amount of searching required to locate the directory entry for a given file. The 
hashed value of the file name indicates the directory sector on which the file information is 
most likely to reside. The data on that sector will indicate if the file exists or if another direc- 
tory sector should be searched. 

Each directory entry gives the name, user identification, and type of the file. Each entry con- 
tains pointers to the first and last pages of the file. In addition, two dates and times are kept 
for each file. One is the date and time that the file was last accessed. This is modified with 
the system date and time whenever the file is opened. The other is the date and time that the 
file was modified. 



User Libraries 

Libraries are a collection of relocatable modules that are stored on the system disc and can 
be referenced by the linker. 

If a library file name is given as a response to the linker's "object files?" query, all the 
relocatable modules in the library file will be relocated and linked. If a library file name is 
given as a response to the "library files?" query, only those relocatable modules that define 
the unsatisfied externals will be relocated and linked. The remaining relocatable modules in 
the library file are ignored. It is possible to combine relocatables into a library by using the 
system library command. 
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FILE MANAGEMENT COMMANDS 



All 64000 files are either disc or predefined device files. Disc files are specified by the user. 
Table 2-1 presents a listing of file management commands and their uses. The syntax for 
these commands is listed alphabetically under System Command Syntax in Chapter 3 of this 
manual. 



Table 2-1. File Management Commands 



File Mgmt. 
Command 


Purpose 


append 


Used to append file to end of files on tape. 


<CMDFILE> 


Used to indicate a command file operation. 


copy 


Used to move a file from one destination to 
another. 


date&time 


Used to set or display date and time. 


directory- 


Provides listing of files on bus disc, tape, 
or floppy disc. 


library 


Used to append one relocatable file to 
another. 


log 


Used to log commands to file. 


purge 


Purges file(s) from system. 


recover 


If a file is available, it allows that file to 
be recovered from a purged state. 


rename 


Changes file(s) from one name to another. 


restore 


Copies file(s) from tape or floppy disc to bus 
disc. 


store 


Copies file(s) from bus disc to tape 
or floppy disc. 


userid 


Used to establish user identification. 


verify 


Compares bus disc file(s) to tape or floppy 
disc f ile(s) . 
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Chapter 3 

SYSTEM COMMANDS 

SYSTEM MONITOR 



General Information 



This chapter is a reference guide to all commands issuable from the system monitor. Other subsys- 
tems (e.g., the editor) have their own monitors and the commands available in them are described 
in the subsystem reference manuals. 

First will be a discussion of commands on system monitor softkeys as they vary with mainframes 
and optional hardware; next are seven definitions for frequently used syntax elements; and, finally, 
all system monitor commands are described in alphabetical order for quick reference. 

Variation of Monitor Softkeys with Hardware 

The first level of softkeys in the system monitor appear as: 

[edit] [compile] [assemble] [link] [_*__] [prom prog] [run] [ — ETC — / 

where [_*_] varies with hardware as follows: 

[meassys] - appears when two or more hardware options for microprocessor sys- 

tem measurement are installed in the mainframe. These hardware op- 
tions include emulators, state analyzers, timing, and software perfor- 
mance analyzers. 

[emulate] - appears when a single emulator control board is installed in the 

mainframe with no state, timing, or software performance analyzer. 

[state] - appears when a single state analyzer control board is installed in the 

mainframe with no emulator, timing, or software performance analyzer. 

[timing] - appears when a single timing analyzer control board is installed in the 

mainframe with no emulator, state, or software performance analyzer. 

The second level of softkeys (reached by pressing the / — ETC — / key from the first level) does 
not vary with hardware options and always appears as: 

[directory] [purge] [rename] [copy] [library] [recover] [log] [ — ETC — / 

Since the directory command allows listing of the directory on the system disc as well as on local 
storage media, the softkeys reached following it vary with local storage options. They appear as: 

[<\CjS\~FI LE>] [any char] [any string] [all users] [recfiles] [_*_] [_**_] [listfile] 

where [_"'_] varies as follows: 
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[tapefiles] 
[floppy] 



- unlabelled in the case of no local storage or stand-alone operation from a 
floppy disc. 

- appears when "DC100" mini-cartridge tape drive is installed in the 
mainframe. 

- appears when dual mini-floppy drive is installed in the mainframe and sta- 
tion is on a hard disc system. 

- unlabelled unless the system hard disc is a CS/80 disc with an integrated 
controller and a "DC600" streaming tape unit. In that case, the softkey 
appears as [dc600] to allow the user to look at the directory of a 
"DC600" cartridge that is used as a streaming tape backup for these 
discs. 

The copy command also varies with hardware configuration. When the mainframe is running 
standalone from a floppy disc, the rear panel HP-IB port is freed for HP-IB protocol use and the 
commands "copy FILE to hpib" and "copy hpib to ..." are permitted. The inner level softkeys cor- 
respondingly vary to show the keyword "hpib" when the mainframe is running standalone from a 
floppy disc. 

The third level of system monitor softkeys (reached by the [ — ETC — ] softkey from the second 
level) appear as: 

[userid][date&tlme] [opt Jest] [<CMDFlLE>] [gen db][-DATACOM-][J_][—ETC—] 

Pressing the -DATACOM- softkey brings up another level of softkeys: 

terminal rs232cntl [ ] [ / / / / / [ / / ] 

Also, /_*__/ varies, depending on whether a hard or floppy disc is the system disc, as 
follows: 



[-BACKUP-] 



[floppy] 



- nothing appears if the system disc is a hard disc which is not a 
CS/80 disc with an integrated controller and DC600 streaming 
tape unit, and there is no local mass storage installed in the 
mainframe. 

- appears if floppy or tape local mass storage is installed in the 
mainframe, or if the system hard disc is a CS/80 disc with an in- 
tegrated controller and DC600 streaming tape unit. 

- appears if the mainframe is running standalone from a floppy disc. 



When the [-BACKUP—] softkey appears on the third level of softkeys, pressing it brings up a 
fourth level that appears in three different formats. If the mainframe has a tape option installed, the 
softkey display appears as follows: 

[store] [restore] [ap pend] [verify ] [tension] [directory ] [ ][ — ETC — ] 

If the mainframe has a floppy option installed, the softkey display appears as follows: 

[store] [restore] [verify ] [delete] [directory ] [floppy ] [ // — ETC — ] 
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If the mainframe has no tape or floppy installed, the softkey display appears as follows: 

[store] [restore] [ / / ] [ ] [directory] [ / [—ETC—] 

This occurs only when the system disc is a CS/80 disc with an integrated controller and a DC600 
streaming tape unit. Therefore, the store, restore, and directory functions apply only to the DC600 
unit. In this case, pressing these function keys will display: "store to_dc600", "restore 
from_dc600", and "directory dc600", respectively. 

DISC ACCESS DURING STREAMING TAPE BACKUP 



This information applies only when the HP 64000 System includes a CS/80 hard disc with an in- 
tegrated controller and a DC600 streaming tape unit. Disc access should be avoided during the 
entire process of storing or restoring files with the streaming tape. This includes the time just after 
a tape cartridge has been inserted into the tape drive, which is when a "conditioning" process oc- 
curs. The following paragraphs describe what happens with two different software versions if a 
disc access is requested during or just after the "conditioning". Also included is a description of 
what happens if a disc access is attempted during either a store or restore operation using the 
streaming tape. 

Software Version 1.39 Or Lower 

With a software version 1.39 or lower, when a streaming tape cartridge is inserted into the tape 
drive of the disc and a disc access is attempted before "conditioning" is completed, the disc driver 
could lock up . A STATUS message reading ERROR: Bus Disc down will appear and it then will be 
necessary to reboot the system. 

Software Version 2.00 Or Higher 

With a software version of 2.00 or higher, when a streaming tape cartridge is inserted into the tape 
drive of the disc, the following two sequences will apply with respect to disc access and the "con- 
ditioning" process: 

1. If an HP 64000 station attempts a disc access during the tape loading/"conditioning" 
process, the STATUS line message reading ERROR: Bus Disc down appears on-screen for 
approximately four seconds. After the "conditioning" is completed, the original station which 
attempted the access receives a STATUS message reading ERROR: Recovered, which is 
displayed briefly and normal disc operation is resumed. 

2. The first HP 64000 station which accesses the disc after "conditioning" is completed also 
receives the STATUS line message reading ERROR: Bus Disc down, which appears for ap- 
proximately four seconds. The STATUS line on this disc will then briefly display ERROR: 
Recovered, and normal disc operation resumes. 

Neither of these two situations will result in a disc lockup (as may be the case for software versions 
before 2.00). 



3-3 



System Software 
Reference Manual 



Disc Access During Store Or Restore 

Disc access from HP 64000 stations should not be attempted during either a store or restore 
operation with the DC600 streaming tape. However, if a disc access is requested during either 
store or restore, a STATUS line message reading I/O Bus wait will appear periodically on-screen at 
that station which made the request. As soon as the store or restore operation is done, normal 
disc operation resumes. 

PREDEFINED SYNTAX ELEMENTS 



The following syntax elements (table 3-1) are used frequently throughout the system commands 
that are listed in this chapter. They are predefined here to avoid extreme repetition. 

NOTE 

Angle brackets denote frequently used syntax elements which are 
predefined prior to command discussions. 

Lower-case syntax elements are composed of key words and user data. 
Upper-case syntax elements are composed only of user-defined data. For 
example, <list destination> is a predefined element which is used in all 
commands having a listing destination as part of their output. 



Table 3-1. Predefined Syntax Elements 



Used for calendar dates. 

Used to reference files by date. 

Used to reference bus disc files. 

Used to reference groups of files. 

Used to reference files by type. 
<list destination> Used to specify listing output. 
<USERID> Used to specify user identification. 



<DATE> 

<date qualifier> 

<FILE> 

<file group> 

<file type> 



The syntax descriptions of the predefined elements listed in table 3-1 are given on the following 
pages. 
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<DATE> 



SYNTAX 



DAY/MONTH/YEAR 

or 
DAY. MONTH. YEAR 



Example: 

2/1/83 Equivalent to calendar date 2 Jan 1983. 

FUNCTION 

Used to enter calendar dates into the system. 

Parameters: 

DAY 



MONTH 
YEAR 



dd = day (1 through 31). 

mm = month (1 through 12). yy = year (two or four digits). 

Calendar accurate from January 1, 1977 to year 2167. 



DESCRIPTION 



Dates are used in the system either in setting the date (see date&time command) or for referring to 
files by the date which they have associated with them (see <date qualifier^. 
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SYNTAX 



modi f ied 
accessed 




<DATE> 



NOTE 

The date qualifier may be used if the time and date are not set. For long 
term projects the date and time should be set to provide accurate 
management of all files. 



Example: 
modified before 2/6/81 Refers to files modified before 2 June 1981, 



FUNCTION 

Selects files modified (written to) before or after a given date. Selects files accessed (read from) 
before or after a given date. 



Parameters: 

modified 

accessed 

before 

after 

<DATE> 



- Written to. 

- Read from. 

- Longer ago than (exclusive of date specified). 

- More recent than (exclusive of date specified). 

- see <DATE> syntax. 



DESCRIPTION 

The <date qualifier allows accurate and up-to-date file management control. As a file is accessed 
or modified, the current date is copied to the directory giving the latest information on that par- 
ticular file. 
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<FILE> 



SYNTAX 



FILENAME [:USERID] [:DISC LU#] 



Examples: 

PROG1:MAX:1 
PROG1: 
PROQ1 
PROG1:0 



File PROG1 with userid MAX on disc assigned logical unit (LU) #1. 
File PROG1 with the blank userid on all bus disc. 
File PROG1 with the current userid on all bus discs. 
File PROG1 with the current userid on bus disc LU 0. 



REFERENCES 

All commands involving disc files. 



FUNCTION 



Format used to identify the attributes of a file. 



Parameters: 

FILENAME 



USERID 



Up to 9 alphanumeric characters starting with an upper-case alphabetic 
character. If a file name greater than 9 characters is used, only the first 9 
characters are significant. Underscore is the only special alphanumeric 
character permitted. 

Up to 6 alphanumeric characters starting with an upper case alphabetic 
character. If a userid greater than 6 characters is used, only the first 6 
characters are significant. Userid may be blank. 
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DISC LU # When no logical unit number is specified, the default is to act on the file 

meeting name, userid, and type qualifiers on the bus disc of lowest LU value. 
For example, if source file A exists on bus discs and 1, the "edit A" com- 
mand will bring in A on bus disc 0. If A on bus disc is later purged, the 
same command will bring in A on bus disc 1. 



NOTE 

Single bus disc users need not make reference to disc LU numbers. 



DESCRIPTION 

A file name is required for all files. File names are user definable and must be entered from the 
keyboard. Implied in all file names are :userid and :disc #. 

The userid permits user code identification and a method of code management. 

In multidisc systems, :DISC LU # is used to manage the placement and retrieval of code from dif- 
ferent bus discs. 

The following conventions are used when file names are displayed: 

• Files are always displayed with file name and userid. 

• The bus disc logical unit number is displayed only if it is nonzero. 

• The type of the file is displayed if not implied by the context of the command. 
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<file group> 



SYNTAX 



al 1 files 
FILENAME 



:all_userids 
:USERID 



[:DISC #] 



Examples: 



al! files 

all files:all userids 

F:MAX:1 

Frail userids:0 



References files of any name with the current userid on all bus 
discs. 

References files of any name with any userid on all bus discs. 

References files named F with userid MAX on bus disc LU 1. 

References files named F with any userid on bus disc LU 0. 



Parameters: 

all files 
all userids 
FILENAME 
USERID 
DISC LU # 



Files of any name. 
Files with any userid. 
See <FILE> syntax. 
See <USERID> syntax. 
See <FILE> syntax. 



DESCRIPTION 

The <file group> construct allows the use of two "wild card" specifiers in selecting groups of files 
to be used in a command. The alljilcs allows files of any name to be referenced. The al- 
l userids allows files with any userid to be specified. 
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SYNTAX 





r 






source 






reloc 






absolute 






1 isting 






emu! com 






1 ink com 




• 


prom 

asmb sym 
1 ink sym 
data 
trace 
comp sym 
asmb db 
comp db 


- 



Examples: 

BOB1:source 

Math:reloc 

DM:absolute 



Source file named BOB1. 
File created by assembly of source file Math. 
File created by link of link com file DM. 
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<list destination> 



SYNTAX 



- 


<FILE> 
printer 

display 
null 


• 



Default Values 

The default for <list destination is specified by the user at the time the userid is entered. 
Thereafter, if no new destination is entered, the selected default is used. 

Examples: 

LIST 
printer 



Specifies listing output to file LIST of type listing. 
Specifies listing output to line printer. 



Parameters: 

<FILE> 
printer 
display 
null 



See <FILE> syntax. The type associated with this file is listing. 
Specifies output listing be printed at the line printer. 
Specifies output listing be rolled on the display in the data area. 
Specifies no listing output (except errors). 



DESCRIPTION 

The <list destination> allows selection of the file or device for output listing. In certain instances, 
the contents of such a listing output may be qualified by options contained within the command. 
Listing files may be viewed with the editor; but, since they are not source files, modification of list- 
ing files has no value except possibly for user convenience in viewing them. 
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<USERID> 



SYNTAX 



USERID 



Default Value 

USERID - current userid 



Examples: 

PROG1:MAX Refers to file PROG1 with userid MAX, all bus discs. 

PROG1: Refers to file PROG1 with blank userid. 



FUNCTION 

Used to set userid. 
Parameters: 

USERID 



Up to 6 alphanumeric characters starting with an upper case alphabetic 
character. If a userid greater than 6 characters is used, only the first 6 
characters are significant. Userid may be blank. 



DESCRIPTION 

Userids are provided primarily as a convenience in managing files. Once specified in a userid 
command, all file references made thereafter are assumed to be to files under the current userid. 
Thus, references to files of another userid must be explicit. This allows a free hand in naming files, 
as the same name may be used unambiguously under multiple userids. 
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SYSTEM COMMAND SYNTAX 

The system commands are presented in alphabetical order on the following pages. 
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append 



SYNTAX 



*append [<file group> [:<file type>] [<date qualifier>]] 
[listfile <list destination^ 

*0nly appears on systems with mini -cartridge 
tape backup. 



Default Values 



<file group> 
<file type> 

<date qualifier> 

<list destination> 



Defaults to files of any name with current userid on all bus disc. 

If no type is specified the types source, emul com, link_com, and 
trace are assumed. 

If no date qualifier is specified, dates are ignored and do not affect 
files being appended to tape. 

Defaults to user specified listfile default. See userid command 
syntax. 



Examples: 

append 

append X:all userids 



append all files modified 
after 1 5/2/82 



Appends to tape all files with current userid of type source, 
emul com, and link com. 

Appends to tape, all files named X:source with any userid of 
type source on all bus discs. 

Appends to tape all files under current userid that have been 
"written to" since February 15, 1982. 
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FUNCTION 

Append allows bus disc files to be added to an already existing tape without changing the files al- 
ready on tape. 

Parameters: 

<file group> 
<file type> 
<date qualifier 
<list destination> 



File or files to be appended. 
Type of file or files to be appended. 
Selects files by modified/accessed date. 
Selects file or device for listing output. 



DESCRIPTION 

This command copies files to the end of a tape with existing files. The tape directory is updated 
with the correct file name after all designated files have been appended to the tape. 
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assemble 



SYNTAX 



assemble <FILE> [listfile <list destination^ 



options 



list 
nol ist 



[expand] [nocode] [xref] 



Default Values 
<list destination 

options 



By default, listing output is sent to the listfile default specified in last 
userid command. 

If options are not entered, all listings occur as per pseudo instructions 
specified in the source file. If options are specified, followed by noth- 
ing, then: 

Output listing of source program with object codes and error 
messages. 

* No expansion of macros and multiple-byte pseudo instructions. 

* No listing of the symbol cross-reference list. 
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Examples: 

assemble SAM Assembles source file SAM; output listing to specified listfile default. 

assemble SAM listfile CHARLEY 

Assembles source file SAM; output listing to file CHARLEY of type listing. 

assemble SAM listfile display options nolist nocode 

Assembles source file SAM; producing no relocatable file and listing only er- 
rors to the display. 



FUNCTION 

The assembler translates source program inputs into relocatable object modules that can be linked 
and loaded into the emulator or programmed into PROMs. Absolute addresses are assigned by 
the linker. 



Parameters: 

<FILE> 

<list destination> 

options 

list 

nolist 

expand 



nocode 



xref 



Source file to be assembled. Selects file or device for listing output. 

See <list destination> syntax. 

Allows user to override listing options specified in the source file. 

Overrides all list and nolist pseudos in the source file and forces list- 
ing of all lines. 

Overrides all list and nolist pseudos in the source file and forces no 
listing except errors. 

Overrides all list and expand pseudos in the source file and forces ex- 
panded list of all areas selected for listing in source file. 

Causes assembly with no object code generation or relocatable file 
creation. 

Causes a cross-reference to be printed to the <list destinations 



DESCRIPTION 

Refer to the Assembler/Linker Reference Manual for a detailed description of the assembler. 
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<CMDFILE> 



SYNTAX 



<FILE> [PARMS] 



Examples: 

OD 

OD:Tom 

OD:Tom Prog Dash 



File name OD, current userid 

File name OD, userid Tom 

File name OD, userid Tom with passed parameters Prog and Dash 



FUNCTION 



Typing a command file name in the command area and pressing [return) begins execution of 
commands in file in sequence. 



Parameters: 

<FILE> 

PARMS 
DESCRIPTION 



A command file is a source file that consists of a series of valid system 
commands. 

ASCII text "passed" to a command file. Any continuous set of ASCII charac- 
ters (no spaces may be passed). 



Command files are source files (created in edit mode or by using the log command) consisting of 
valid system commands to be executed in sequence. Command files provide a convenient 
method of passing parameters and a method of structuring a series of commands to be evoked 
with a minimum amount of keystrokes. The commands start in the system monitor and end with 
the last command in the file. 
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The commands are all executed conditional upon syntactical or semantic errors. If syntactical 
errors are encountered during execution, the sequence will abort at that point. In addition to valid 
system commands, a parameter declaration line may optionally precede commands in a command 
file. 

The parameter declaration line is used to pass variable parameters from a command file. The sys- 
tem will prompt for the actual parameter or the parameter can be typed in the command line along 
with the command file name. 

Formal parameters may be used in any system command in place of any ASCII text not containing 
spaces. The ASCII text passed (in a passed parameter) will be directly substituted for the formal 
parameter at the time the command file is executed. This is referred to as CALL BY NAME. 

Refer to Chapter 1 for several detailed examples of Command Files. 
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compile 



SYNTAX 



compile <FILE> [listfile <list destination^ 



options 



list 
nol ist 



[expand] [nocode] [xref ] [comp_sym] 



Default Values 



<list destination> 



options 



By default, listing output is sent to the listfile default specified in last 
userid command. 

If options are not entered, all listings occur as per pseudo instructions 
specified in the source file. If options are specified, followed by noth- 
ing, then: 

Output listing of source program with object codes, and error 
messages. 

• No expansion to show generated assembly language. 

• No listing of the symbol cross-reference list. 

• No comp_sym file generation. 
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Examples: 

compile PASCALPRG 



Compiles source file PASCALPRG with output listing to specified 
listfile default. 



compile PASCALPRG listfile MYLIST 

Compiles source file PASCALPRG; listing to file MYLIST of type listing. 

compile PASCALPRG listfile display options nolist nocode 

Compiles source file PASCALPRG producing no relocatable file and 
listing only errors to the display. 

FUNCTION 

Initiate compile function for source programs. 
Parameters: 



<FILE> 

<list destination> 

options 

list 

nolist 

expand 

nocode 

xref 
comp_sym 



Source file to be assembled. See <FILE> syntax. 

File or device for listing output. 

Allows user to override listing options specified in the source file 

Overrides all list and nolist pseudos in the source file and forces list- 
ing of all lines. 

Overrides all list and nolist pseudos in the source file and forces no 
listing except errors. 

Overrides all list and expand pseudos in the source file and forces ex- 
panded list of all areas selected for listing in source file. 

Causes compilation with no object code generation nor relocatable 
file creation. 

Causes a cross-reference listing to be printed to the <list destinations 

This file is created by the compiler when requested and contains the 
entire compiler symbol table for use in creating comp_db (refer to link 
syntax for a description of comp _db file). 



DESCRIPTION 

Refer to Compiler or Host Pascal Reference Manual for a detailed description of the compiler. 
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copy 



SYNTAX 



<FILE>[:<file type>] to 



<FILE>[:<file type>] 
rs232 
■ display 
printer 
*hpib 



*hpib 
I rs232 J 

display 



to <FILE>[:listing[options disc_image]] 



to 




*0nly appears on systems using floppy as 
system disc. 



Default Values 



<file type> 
:listing 

options disc_image 



Defaults to type source or listing with source taking precedence. If this 
is not specified, default is to same type file as that of the "from" file. 

For files of type reloc, absolute, asmb_sym, and linksym: the default 
format of a listing of these files decodes the data. This decoding can be 
overridden by options discimage. 
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Examples: 

copy PROG1 to 
printer 

copy PROG1 to 
rs232 

copy rs232 to 

NEWFILE 



Prints source file or listing PROG1 to the line printer. 

Writes source or listing file PROG1 out over RS-232 link. 

Reads from RS-232 input and writes input into source file NEWFILE. 



copy PROG1 absolute to PROG2 

Copies file PROG1 type absolute into file PROG2 type absolute. 

FUNCTION 

Gives the user the capability of duplicating any file on bus disc by copying it to a file of another 
name. Also allows for communication with the RS-232 link for both input and output. 

Additionally, the copy command is valuable in viewing files not normally observable by the user. By 
copying a non-ASCII file to a device or file of type listing, the user may obtain a readable version of 
the binary file's contents. In the case of relocatable, absolute, asmb_sym, and link sym files, copy 
decodes somewhat the binary information in listing it (this decoding may be overridden using op- 
tions disc image). Otherwise, the binary data is output in hexadecimal and ASCII. 



Parameters 

<FILE> 
<file type> 

rs232 

display 

printer 

options disc_image 

DESCRIPTION 



Name of file to be copied from or to. Type of file to be copied. 

Designates input or output over RS-232 link. 

Designates input or output from the data area of the display. 

Designates output to the printer. 

Overrides decoding of binary data forcing ASCII and hexadecimal 
dumps of all data in file. 



The copy command is used to move a file from one destination to another. When moving files 
through the RS-232 link, refer to the Installation and Configuration Manual for information regard- 
ing control signals, timing diagrams, and format requirements. 
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date&time 



SYNTAX 



date&time [<DATE>][HOURS:MINUTES] 



Default Values 



<DATE> 



If no date is specified, the current system date is displayed on the status 
line. 



HOURS:MINUTES If no time is specified, the current system time is displayed on the status 

line. 



Example: 

date&time 
27/2/81 

date&time 13:15 

date&time 
27.2.81 9:45 



Sets current system date to Wed, 27 Feb, 1981. 

Sets time to 13:15 (24-hour clock). 
Sets both date and time. 



FUNCTION 

Allows user to set the current date and time into the system. 
Parameters: 

<DATE> Day of year. 

HOURS 0-24. 

MINUTES 0-59. 
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DESCRIPTION 

The 64000 operating system maintains a clock/calendar for use by the various software develop- 
ment modules. All generated listings contain the current time and date as a heading. The time 
and date of creation or modification of files is also maintained and can be displayed in a directory 
listing of files. The clock is derived from the power line and automatically accounts for either 
50-Hz or 60-Hz line frequency. The internal calendar is accurate from January 1, 1977 to the year 
2167. 

At power up, one development station can be used to set the time and date on all development 
stations; clock time is continuously displayed at the far right of the status line. If the time is not 
set, it starts at 00:00. It can be changed by issuing the date&time command. If the clock is reset 
on any development station, all stations will reflect that change. If the date is not set at power up, 
the system date defaults to the software revision date. If the development station is left on at all 
times and the date and time have been set, the correct date and time will be automatically 
maintained. 
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SYNTAX 









directory 


<|C||S| FILE GROUP>[:<file type>] [<date qualified] 
all_userids[:DISC LU#][:<file type>][<date 

qualifier>] 
recoverable files 
*tape_files 
**f loppy files 
***dc600 [<file group> [:<file type>]] 




[listfile <list destination^ 


*Appears only on systems with tape option 


**Appears only on systems with floppy option 


***Appears only on systems with bus discs having 
an integral tape backup. NOTE: discs requiring 
multiple DC600 cartridges for backup do not permit 
this function. No dc600 directory can be listed. 



Default Values 

<|C| |S| FILEGROUP> 

<file type> 
<date qualifier 

<list destination 



Default is all files under current userid. 

Default is all types. Default is to ignore modified and accessed dates. 

Defaults to user specified listfile default. See userid command syntax. 
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Examples: 



directory 



List all files of all types on bus disc LU with the current userid to the 
default listfile device or file. 



directory A |S| Lists all files beginning with A under current userid. 

directory all files:all_userids:source 

List all files of type source on bus disc LU with any userid to the default 
list device or file. 

directory all_files:SAM modified before 26/1/81 

Lists all files of all types with userid SAM which were modified before 26 
Jan 1981. 



FUNCTION 

Provides a selective listing of bus disc files, all files on a tape or floppy, or all available recoverable 
files. 



Parameters 
<|C| |S| FILE QROUP> 

<file group> 
<file type> 
<date qualifier 
floppy files 
tapefiles 
recoverable_files 
dc600 



Files to be included in directory. Syntax is identical to that of <file 
group> except that the special symbols |C| (equivalent to any non- 
blank character) and |S| (equivalent to any string (includes blanks)) 
are allowed in FILENAME and USERID. 

Files to be included in directory of dc600. 

Type of files to be included in directory. 

Allows viewing of files by last modification or access date. 

Specifies a directory of all files stored on an inserted floppy. 

Specifies a directory of all files stored on an inserted tape. 

Specifies a directory of all recoverable files. 

Specifies a directory of a "DC600" type streaming tape (imple- 
mented only on systems with bus discs having an integral tape 
backup). 
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DESCRIPTION 

The directory command provides a means of listing the files accessible by the system. Unique 
qualifiers (File names, user id's, file types, etc.) provide a means of selecting certain files. The spe- 
cial symbols for anycharacter (|C| and |S|) behave exactly as in the editor string (refer to the 
Editor Reference Manual for a detailed description). 

When a directory command is executed, information regarding the files and bus disc space is 
given. At the end of each userid is listed the number of files listed for that userid and the total 
amount of bus disc space (in percent) which that user is occupying. After all userid's are listed, 
the total amount of bus disc space available is listed. The total space used is the summation of all 
space used by the various users. 

When a recoverable file directory command is executed, an accounting of the total number of files 
listed is given along with the total amount of bus disc space used. The space used is a percent of 
the total amount of bus disc space available. 

When a directory listing of a multidisc system is run, the listings are in bus disc order-i.e. discO, 
disci, etc.. Each userid has the number of files listed and the percent of bus disc space used. 
The last listing for the bus disc will include the percent of bus disc space available. The command 
directory all files:HP will display the system software and date. 
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edit 



SYNTAX 



edit [<FILE>] 


rsource 
. : 1 i sting . 


[into <FILE>] 



Default Values 



<FILE> 



The input file defaults to a new file of type source to be named at completion 
of edit. 



:source 
:listing 



The destination file defaults to the input file name (if specified). This 
facilitates editing a file and keeping the edited version by the same name. 

Defaults to type source if neither is specified. 



Examples: 

edit 



Requests the editor for the purpose of editing a new file to be named 
at completion of edit. 



edit into PROG1 



Requests the editor for the purpose of editing a new file to be named 
PROG1 with the current userid. 



edit PROQ1 



Requests the editor for the purpose of editing an already existing 
source file named PROG1 with current userid. 



edit OUTPUT:listing 



Requests the editor for the purpose of viewing a listing output 
created by a previous list destination specifier of OUTPUT under cur- 
rent userid. 
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FUNCTION 

The edit command evokes the editor to create a new file or edit an existing file. A file may be 
edited into another file through the use of the key word "into". 



Parameters: 

<FILE> 



Input file is the file to be edited. 

Destination file is where edited file is to be kept upon completion of edit. 



:source 



Misting 



Specifies edit of the source file by the given name as opposed to the listing 
file. 

Specifies the desire to view a listing file by the given name. 



DESCRIPTION 

The edit command is the user interface to the text editor. It allows specified files to be edited or 
viewed as well as specification of destination of edited files. Once a file is correctly specified, the 
editor is entered and, until ended or reset, further commands are for the purpose of text editing. 
Refer to the Editor Manual for a description of the Editor. 
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emulate 



SYNTAX 



edit 
♦emulate [<FILE>] [load <FILE>] [options \ \ ] 

continue 



♦Appears only when a single emulator/analyzer and no 
state or Liming analysis options are installed. 



Default Values 



<FILE> 



The command file default is to create a new emulator command file. 
The load file default is to load no absolute file at time emulation is begun. 



Examples: 



emulate CMD6800 



emulate load 
PROGABS 



Requests that the emulator be run and configured with the information 
CMD6800 type emulcom. 

Requests the emulator be run with an opportunity to create a new 
emul com file describing emulation configuration and that file 
PROGABS type absolute be loaded into emulation RAM. 



emulate CMD8080 options edit 



Requests the emulator to be run with an opportunity to edit emulcom 
file CMD8080 prior to entering emulation. The processor will be restarted. 
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emulate CMD8080 oplions continue 



Requests the emulator to be entered without restarting the processor. 
The status of the processor on entry is not necessarily "ready" but rather 
whatever state the processor is currently in. This allows for exit and 
resumption of emulation without disturbing the processor for hardware 
purposes. 



FUNCTION 

Evokes the emulation function installed in the mainframe. Refer to the appropriate Processor 
Emulation Manual for a detailed explanation. 

Parameters: 

<FILE> The command file is of type emulcom and was created in a previous con- 

figuration interrogation session in the emulator. It allows the user to evoke 
the emulator with the same configuration previously specified. 

load <FILE> The load file is of type absolute and allows the user to specify that an ab- 

solute file created by the linker is to be loaded into emulation RAM. 

edit Allows the user to edit responses in an existing emul_com file. 

continue Allows the user to enter emulation without restarting the processor. 

DESCRIPTION 

The emulate command is a means of accessing the 64000 emulator. The emulator together with 
hardware options allows execution of an absolute file and optionally I/O simulation. With certain 
analysis options, real-time analysis of executing programs is possible to aid both hardware and 
software development. Once the emulate command is correctly specified, further commands are 
for direction of emulation. Refer to the specific Emulation Reference Manual for a description of 
the emulator. The [emulate] softkey display on the CRT will vary with the hardware configura- 
tion of the system. If a state or timing analyzer is installed in the system, along with the emulation 
hardware, the softkey display will be [meas sys] . Issuing the "measurement_system" command 
will allow the user to select (by way of a new softkey configuration) either emulation, state analysis, 
or timing analysis. 
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floppy 



SYNTAX 









*f loppy 


utilities 

system_generator 

lif_utilities 


* 


*Appears only on stations with floppy option 
installed. 



FUNCTION 

Allows entry into floppy utilities monitor or floppy system generator monitor. 
Parameters: 



utilities 



lif utilities 



Specifies entry into monitor for formatting, testing, and physically duplicat- 
ing floppies. 



systemgenerator Specifies entry into monitor for generating floppy discs containing specific 

system software. 



Specifies entry into the monitor for generating floppy discs in Logical 
Interchange Format (LIF). 



DESCRIPTION 

The softkey [utilities] accesses the five utility routines: format, copy, verify, read test, and write 
test. The softkey [system generator] accesses the system software module manager (SSMM). The 
SSMM allows the user to show, copy, or remove system modules on the bus disc(s) or flexible dis- 
c(s). Refer to the Flexible Disc Drive Reference Manual for a detailed description. The softkey 
[lif utilities] accesses the commands: store, restore, verify, delete, directory format, duplicate, and 
compare for floppies stored in LIF. Refer to the Floppy Disc Reference Manual for a detailed 
description. 
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generate database 



SYNTAX 



generate_database 


<FILE> using <FILE> 

comp sym <FILE> 

compdb <FILE> using <FILE> 


>■ 



Examples: 

generatedatabase CSOURCE using CJJNKSYM 

The files C_SOURCE:comp_sym and C_SOURCE:comp db are generated. 
CSOURCE is a C source file and C_LINKSYM is a link_sym file generated by a 
previous link of C_SOURCE with other relocatables. 

generate_database compsym PASCALSOURCE 

The file PASCAL_SOURCE:comp_sym is generated, 
generatedatabase comp_db PASCAL_SOURCE using PASCAL_LINKSYM 

The file PASCAL_SOURCE:comp_db is generated. 

FUNCTION 

Allows generation of comp_sym and compdb symbol databases without the overhead of recompila- 
tion and relinking. 
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Parameters: 

<FILE> Pascal or C source file for which comp_sym and/or comp_db files are to be 

generated. In order for the database generator to distinguish the two, C source 
files must have "C" for their first line and PASCAL source files must have "PASCAL" 
for their first line. 

using <FILE> linksym file generated by a previous link. 

compsym Specifies that only a comp_sym file be generated. 

comp_db Specifies that only a comp_db file be generated. 

DESCRIPTION 

The generatedatabase command allows the generation of type compsym and comp_db files 
directly. These files are also optionally generated by the compiler (see compile options compsym) 
and the linker (see link options compdb). This is of particular interest to users running the compiler 
and linker on a mainframe hosted development station and not creating these files. 
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library 



SYNTAX 



library <FILE> to <FILE> 



Examples: 



library OLDRELOC 
to NEWLIB 

library NEXTRELOC 
to NEWLIB 



If NEWLIB:relocatable does not exist it is created and contains identi- 
cally OLDRELOC. 

Now NEXTRELOC is appended to NEWLIB which contains 
OLDRELOC. 



FUNCTION 

The library command is used to build libraries of relocatable files for use by the linker. Library files 
consist of relocatable files to be selectively loaded by the linker. 

Parameters: 

<FILE> is assumed to be type relocatable. 

DESCRIPTION 

A library file is merely several relocatable files appended together to form one large relocatable file. 
Note that the "to" <FILE> need not already exist. If it does exist, the specified file is appended to it. 
If it does not exist, it is created and filled with the specified file. 

Libraries provide a convenient way to specify a group of relocatable files to be used at link time. It is 
often more efficient for the linker to handle library files since some of the overhead of finding and 
opening multiple relocatable files is eliminated. 
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link 



SYNTAX 



link [<FILE>] [listfile <list destination^ 



options [edit] [noli st] [xref][no_overlap_check] [comp db] [bui 1 d286] 



Default Values 

<FILE> 

<list destination> 
options 



If no linker command file is specified, the default allows creation of a 
new file of type link com. 

Defaults to user specified listfile default. See userid command. 

If "options" is not entered, listing defaults to options specified in the 
linker command file. 

If options is specified, followed by nothing, a load map listing with no 
cross-reference is performed. 



Examples: 

link 

link PROGABS 



link PROGABS 
options edit 



Requests the linker to create a new linker command file. Listing output will 
go to the listfile default. 

Links absolute file PROGABS containing files in linker command file 
PROGABS. Listing output will go to listfile default and options in PROGABS 
type link_com are in effect. 

Request the linker for purpose of viewing or modifying PROGABS:link_com. 
Listing output will go to listfile default. 
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FUNCTION 

The linker combines and relocates specified relocatable files creating an absolute file with the same 
name as that of the link_com file which can be used to program a PROM (with prom programmer 
option) or to load emulation RAM to be executed and analyzed with the emulator. 



Parameters: 

<FILE> 

<list destination> 

options 

nolist 

xref 

edit 
nooverlapcheck 

comp_db 
build286 



A file of type linkcom to be used to direct the linker as to relocatable 
and relocation addresses. 

File or device to which listing output is sent. 

Allows user to override options specified in the linker command file. 

Overrides the list option specified in the linker command file and sup- 
presses output of a load map. 

Overrides no xref option specified in the linker command file and for- 
ces output of a global symbol cross-reference table. 

Allows user to edit existing linkcom file specified. 

Overrides overlap_check option specified in the linker command file 
and suppresses errors caused by memory overlaps. 

This file is created by the linker when requested and is a data base 
containing information from all of the compsym files associated with 
relocatables in an absolute file. 

Invokes 80286 protected mode linker (if installed). This linker 
generates absolute files only for the 80286. See the 80286 Linker 
manual for more information. 



DESCRIPTION 

The link command is the user interface to the HP 64000 linker module. Once the link command is 
correctly specified, further responses are used to direct the linker. Refer to the Assembler/Linker 
Reference Manual for a description of the linker. 
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logcommands 



SYNTAX 



log commands 


to <FILE> 
off 


► 



Examples: 

log commands to 
COMFILE 



After issuing this command, all further commands issued to the system 
will be written to source file COMFILE for use as a system command file 
at a later time. 



logcommands off 



Ends the logging of commands to a source file. 



FUNCTION 



This command permits the logging of commands to a given file. This allows the generation of com- 
plex command files. 



Parameters: 

<FILE> 



Name of source file to which commands are to be logged. 



DESCRIPTION 

This command permits the building of complex command files. Each command (syntactically cor- 
rect) that is executed is logged in sequence in the <FILE>. Once the desired commands have been 
entered, type logcommand off in the command line. This terminates the logcommand function. 

Note: either evoking another command file or editing the file being logged to will implicitly force an 
end to logging. 
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measurement system 



SYNTAX 



*measurement_system [options continue] 

*Appears only when two (2) or more emulators, state 
analyzers, or timing analyzers are installed. 



Default Values 

options If options continue is not specified, all modules are re-initialized on entry. 

FUNCTION 

Allows the user to select from among emulators, state analyzers, timing analyzers, and software per- 
formance analyzers installed in the HP 64000. 



Parameters: 

continue 



Enter measurementsystem monitor, leaving all modules in the state which 
they were in when last ended. 



DESCRIPTION 

Refer to the State Analyzer, Timing Analyzer, or Software Performance Analyzer Reference Manual 
for a detailed description of the measurement system. 
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option test 



SYNTAX 



option test 



FUNCTION 

The optiontest command allows the user to verify the performance of optional boards installed in 
the system's card cage. 



DESCRIPTION 

For a detailed description of a specific performance verification refer to the appropriate service 
manual. 
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prom programmer 



SYNTAX 



promprogrammer 



FUNCTION 

Evokes the promprogrammer for the purpose of reading from, writing to, or verifying supported 
programmable read-only memory (PROM) ICs. 

DESCRIPTION 

Once this command is executed, further commands direct the prom programmer utility. Refer to the 
PROM Programmer Reference Manual for a description of the prom-programmer. 
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purge 



SYNTAX 



purge <FILE> [:<file type>] 



Default Values 



<file type> 



Defaults to all types. 



Examples: 

purge BOB1 
purge BOB1:source 



Purges all files named BOB1 with the current userid of all types. 
Purges source file BOB1 with the current userid. 



FUNCTION 

Remove designated files from active file list. 
Parameters: 

<FILE> Name of file to be purged. 

<file type> Type of file to be purged. 

DESCRIPTION 

As files are purged, the bus disc space allocated to them is freed for any other file use. The purged 
file will remain recoverable until the bus disc space is needed for an active file. There is no guarantee 
on the length of time a file will be recoverable. 

The structure of the purge command is such that the exact file(s) must be specified. This prevents 
accidental purging of files. 
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recover 



SYNTAX 



recover <FILE> [:<file type>] [to <FILE>] 



Default Values 



<file type> 
<FILE> 



Defaults to all types. 

The destination file defaults to the same name as that of the file to be 
recovered. 



Examples: 

recover FILEA 



If recoverable and not already existing, all type names FILEA are recovered. 



recover FILEA 
to FILEX 



Again, types named FILEA will be recovered if possible and named FILEX. 



FUNCTION 

If a file is recoverable, this command will recover the file and place it on the active file portion of the 
bus disc. 

Parameters: 

<FILE> 
<file type> 
to <FILE> 



Name of file to be recovered. 
Type of file to be recovered. 
New name of file recovered. 
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DESCRIPTION 

When a file is purged, the bus disc space allotted is freed for other files. As more active file space is 
needed, the purged files are written over. The files are stored under a first purged, first written over 
philosophy. There is no guarantee as to how long a file is recoverable. 

Due to the limited size of the recoverable files directory, the number of recoverable files cannot ex- 
ceed 127 (63 on floppies). Also, if the space reserved for a recoverable file is needed for an active file 
the number of recoverable files will be reduced. 

The directory list of recoverable files (see directory syntax) provides a list of current recoverable files. 

If the file is not available, the system responds with "file not found" and the file must be restored from 
tape or regenerated. 

Another unique feature of the recover command is that a file which has been edited several times 
may be recovered back to the original source. This is accomplished by recovering the file and 
renaming it to another file name until all files have been recovered. 

Examples: 

recover FILEArsource to FILE1 

This recovers the most recent edited source. 

recover FILEA:source to FILE2 

This recovers the next most recent edited source. 

recover FILEA:source to FILE3 

This recovers the next most recent edited source. 

Repeat this command naming a new "to <FILE>" until the desired version is recovered or the system 
responds with "file not found". 
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rename 



SYNTAX 



rename <FILE> [:<file type>] [to <FILE>] 



Default Values 



<file type> 



Defaults to all types 



Examples: 

rename FILEA to FILEB 

Files names FILEA with the current userid of all types are renamed FILEB. 
rename FILEA:source to FILEB 

Source file FILEA with the current userid is renamed FILEB. 

FUNCTION 

Rename allows the user to change the name of a file(s). 
Parameters: 

<FILE> Current name of file(s). 

to <FILE> New name of file(s). 

<file type> Type of file to be renamed. 

DESCRIPTION 

This function permits the renaming of a file. 
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restore 



SYNTAX 











<file group>[:<file type>][<date qualifier>] 




*restore 


**file # FILE# into <FILE> [:<file type>] 






***from_dc600 


" DC600# " 
. <FILE> . 


[intodisc DISC#] 




[listfile <list destination>] 




*Appears only on systems with tape, floppy, or 
"DC600" type backup running from a bus disc. 




**Appears only on systems with tape option. 




***Appears only on systems with bus disc having an 
integral tape backup. NOTE: Discs requiring 
multiple DC600 cartridges (for example, the 
Model 7914) do not allow selective file 
restore as the directory is split. All tapes 
must be restored completely to the disc. 





Default Values 



<FILE> 
DC600# 

DISC# 
<file group> 
<file type> 



Defaults to all files. 

Defaults to logical unit 8 (the first integral tape backup on the bus 
system). 

Defaults to logical unit 0. 

Defaults to files of any name with current userid on all bus disc. 

Defaults to all types. With a file # referenced file, the default is 
source. 
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<date qualifier If no date qualifier is specified, dates are ignored and do not affect 

files restored. 

<list destination> Defaults to user specified list file default. See userid command. 



Examples: 

restore Restores from tape or floppy, all files with current userid of all types 

on all bus discs. 

restore FILEA:source Restores from tape or floppy, source file FILEA with current userid, 

all bus discs. 

restore file #2 into FILEB:source 

Restores from tape, the second file into a source file named FILEB with the current 
userid on all bus disc. 

restore FILEB:absolute 

Restores from tape or floppy, file FILEB, current userid, type absolute on all bus 
disc. 

restore from_dc600 Restores all of "DC600" backup tape. LU8 defaults to tape at LU 0. 

For discs requiring only one DC600 cartridge for backup, a specific 
single file may be restored to the disc. 



CAUTION 




Restoring a full "DC600" tape cartridge completely restores on the disc 
the information backed up. ALL INFORMATION ON THE DISC IS LOST. 



FUNCTION 

Restore is used to copy tape or floppy file(s) to the bus disc. Information on tape must be in 
Standard Interchange Format (SIF). Restore also allows recovery of information stored on "DC600" 
cartridges. This may be done selectively (except on a disc requiring more than one DC600 
cartridge for backup), or the entire DC600 cartridge contents may be restored, losing the informa- 
tion on the disc. 

NOTE 



For information about disc access during any operation with a DC600 
streaming tape, see explanation under heading of "Backup" earlier in this 

chapter. 
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Parameters: 

<FILE> 
DC600# 

DISC# 
<file group> 
<file type> 
<date qualifier 

FILE# 

<list destination> 



Name of the file to be restored. 

Logical unit number of bus disc having an integral tape backup (8-15 
allowed). 

Logical unit number of system bus disc (0-7 allowed). 

Specifies a file or group of files to be restored. 

Type of files to be restored. 

Allows restoration of files selectively based on date of last modify or 
access. 

Sequence number of file as stored on tape. May be listed with directory 
command for tapes generated on the HP 64000. 

Specifies file or device to receive listing output. 



DESCRIPTION 

The restore command allows the user to retrieve "backed-up" files from tape or floppy. Files stored 
on tape with another system (provided that system used Standard Interchange Format (SIF) in creat- 
ing that tape) may be restored on the system. For files stored to tape or floppy from the HP 64000, 
retrieval may be accomplished by restoring the file by name. For files stored (using SIF) by another 
system, files may only be restored by file # reference since the directory cannot be read or may not 
be present. In the latter case, a file name must be given to the file for purposes of storage on bus 
disc. Such file # referenced files are assumed to be of type source. It is very unlikely that files of 
other types adhere to the HP 64000 conventions. 

Users with bus discs having the integral tape backup may restore from backup (if disc has been 
stored to backup). This may be done altogether (losing disc information) or by filename. Users with 

floppy drive may restore files stored by the HP 64000 either by name or by using the all files and al- 

I userids commands. 
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rs232 remote control 



SYNTAX 





- 






enable 




rs232 remote control 


disable 





FUNCTION 

Allows disabling of remote control via RS232. 

DESCRIPTION 

When an RS232 line is connected to the rear of a station which is configured in a Hosted 
Development environment, the station may be controlled by a host computer terminal. To prevent 
this situation, the user may issue "rs232_remote_control disable ". RS232 control commands are 
then ignored by the system monitor until enabled or the station is powered up or "SHIFT RESET". 
Note that other rs232 functions, e.g., copy FILE to rs232, run X input rs232, simulatedio using rs232 
are unaffected by this command. 
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run 



SYNTAX 



run <FILE> 


input 
output " 


keyboard 
rs 232 
<FILE>[:<file type>] 

<FILE>[:<file type>] 

display 

displayl 

printer 

null 

rs 232 


- 
> 





Default Value 



input if the input keyword is not used, then the file name associated with INPUT is 

keyboard. 

output if the output keyword is not used, then the default file name for OUTPUT is the 

default listing file. If no default listing file has been specified for the present userid, 
then the default listing file is null. 

<file type> If no file type is specified, the input default is to source and the output default is 

to listing. 
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FUNCTION 

The run command causes execution of an absolute psuedo-machine code file that has been com- 
piled on the system Host Pascal compiler. 



Parameters: 

<FILE> 
input <FILE> 
Keyboard 

output <FILE> 
<file type> 
display 
displayl 

printer 
null 
rs 232 



The name of the absolute file containing the pseudo-machine code. 

Disc file from which predefined file INPUT gets data. 

Specifies input from keyboard is to be read as records when predefined file 
INPUT is accessed. 

Disc file to which predefined file OUTPUT writes data. 

Type of file from which input is read or to which output is written. 

When OUTPUT is written to, records scroll past on display. 

Allows random access writes (row and column) to display using predefined 
file OUTPUT. 

When OUTPUT is written to, records go to printer. 

When OUTPUT is written to, records are not saved. 

Capability to input/output over RS-232-C. 



DESCRIPTION 



File names for the standard files INPUT and OUTPUT may be specified in the context of the run 
command. For other program parameters, the system prompts the user for a file name for each addi- 
tional program parameter. If no entry is made following a prompt, the system treats the file as if it 
were not a program parameter. For additional information covering the run command refer to the HP 
64000 Host Pascal Reference Manual. 
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state 



SYNTAX 



■state [<FILE>] [options continued] 



*Appears only when a single state analyzer and no 
emulator, timing analyzer, or software perform- 
ance analyzer boards are installed. 



Default Values 



<FILE> 



options 



If no trace file is specified, entry is such that configuration information from 
previous use of state analysis is not used. 

If options continue is not specified, default is to re-initialize the state module 
upon entry. 



Example: 

state CONF1 
state options continue 



Enter state analysis operation using configuration information con- 
tained in file CONF1:trace. Re-initialize state upon rentry. 

Enter state analysis operation using configuration contained in the 
configuration file used the last time state was entered. Does not re- 
initialize state upon entry. 
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FUNCTION 

Evokes the state analysis function installed in the mainframe. 



Parameters: 

<FILE> 
continue 



Name of trace file containing state configuration information. 

Re-enter state module leaving it in the same condition as it was when it was 
last "ended". 



DESCRIPTION 

The [state] softkey displayed on the CRT will vary with the hardware configuration of the system. If 
an emulator, timing analyzer, or software performance analyzer is installed in the system, along with 
the state analyzer hardware, the softkey display will be [meassys] . 

Issuing the "measurementsystem" command will allow the user to select (by way of a new softkey 
configuration) either emulation, state analysis, or timing analysis. 

Refer to the State Analyzer Reference Manual for a detailed description. 
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store 



SYNTAX 



**store 



<file group>[:<file type>] [<date qualifier>] 
*to_dc600[DC600#][from_d1sc DISC#] [certify] 

[listfile <1 i st destination^ 



^Appears only on systems with bus discs having an 
integral tape backup. 

**Appears only on stations with tape option, floppy 
option, or with bus discs having an integral tape 



backup. 



Default Values 
<DISC#> 
<file group> 
<file type> 

<date qualifier 

<list destination> 
DC600# 

certify 



Defaults to logical unit 0. 

Defaults to files of any name with current userid on all bus disc. 

If no file type is specified, the types source, emulcom, linkcom, and 
trace are assumed. 

If no date qualifier is specified, dates are ignored and do not affect files 
stored to tape or floppy. 

Defaults to user specified listfile default. 

Defaults to logical unit 8 (the first bus disc having an integral tape 
backup. 

If not specified, no certification is performed unless DC600 has never 
been certified. 
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Examples: 

store 



Stores (overwriting previous contents) all files of type source, emul_com, 
linkcom, and trace to tape or floppy. 



store X:all userids:source 



Stores all files named X with any userid on any disc of type source to tape or 
floppy. 



store all files modified after 15/4/81 



Stores all files on any disc of type source, emul_com, linkcom, and trace with 
current userid modified after 15 April, 1981 to tape or floppy. 

store all_files:1:DON 

Stores all files of type source, emul_com, link_com, and trace from disc #1 
with userid DON to tape or floppy. 

store to_dc600 Store entire system disc to "DC600" streaming backup tape at LU 8. 



FUNCTION 

Store is used to copy bus disc file(s) to tape, floppy, or DC600 backup tape. A directory is placed on 
the medium written to. 



Parameters: 

<file group> 
<file type> 
<date qualifier 

<list destination> 
DC600 

DISC# 
certify 



Files to be stored on tape or floppy. 

Type of files to be stored on tape or floppy. 

Allows selection of files to be stored based on last modification or 
access. 

File or device to which listing output is sent. 

Logical unit number of bus disc having an integral tape backup (8-15 
allowed). 

Logical unit number of disc to be backed up. 

Forces a certification of the "DC600" streaming tape prior to backup. If 
tape has never been certified previously, certification is automatically 
performed. 
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DESCRIPTION 

After files are stored, a directory of files is also placed on the storage media. 

To facilitate a regular "back-up" of files on bus disc, it is possible to store to tape or floppy, only 
those files modified (or accessed) since the last back-up. The third example above shows a com- 
mand for storing only those files modified after a given date. 

When storing to "DC600" streaming tapes, all of the information on the disc is stored to the tape 
including the disc directory. Subsequently, it is possible to restore selectively specific files from the 
"DC600" tape or to restore the entire disc to its state at the time the backup was made. (An excep- 
tion to the selective file restore is when the system disc requires more than on DC600 cartridge for 
backup. See restore syntax description for more information on this.) 

"DC600" streaming tapes must be certified before first used. Thereafter, the user may force a "cer- 
tify" using the certify parameter. Following the store of data, a checksum verify is automatically 
performed on the tape data. 

NOTE 



"store all f iles:listing " fails to store the last file onto a cartridge tape when 

the tape becomes full. This only occurs on type listing and only to 
cartridge tapes. 



NOTE 



For information about disc access during any operation with a DC600 
streaming tape, see explanation under heading of "Backup" earlier in this 
chapter. 
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terminal 



SYNTAX 





" 


f hp 1 






terminal 


options 


l»t J 


■ 





FUNCTION 

Executes terminal mode software to allow communication with other systems over RS-232-C. 

The default is "option hp". Select "vt" if you want to use the HP 64000 station as a terminal on 
Digital Equipment Corporation's VAX mainframe. Once this terminal option selection is made the 
terminal mode process continues as defined in the Terminal Mode Operating Manual. 

DESCRIPTION 

Once this command is executed, further commands direct the terminal mode utility. Refer to the 
Terminal Mode Operating Manual for a detailed description of the terminal mode of operation. 
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timing 



SYNTAX 



*timing [<FILE>][options continue] 



*Appears only when a single timing analyzer and no 
emulator, state analyzer, or software perform- 



ance analyzer boards are installed. 



Default Value 



<FILE> 



options 



If no trace file is specified, entry is such that the configuration information 
from previous use of timing analysis is not used. 

If options continue is not specified, default is to re-initialize the timing 
module upon entry. 



Example: 

timing CONF2 
timing optionscontinue 



Enter timing analysis operation using configuration information 
contained in file CONF2:trace and re-initialize timing upon entry. 

Enter timing analysis operation using configuration data contained 
in the configuration file that was used the last time the timing 
command was entered. Does not re-initialize timing upon entry. 
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FUNCTION 

Evokes the timing analysis function installed in the mainframe. 



Parameters: 

<FILE> 
continue 



Name of trace file containing timing configuration information. 

Re-enter timing module leaving it in the same condition as it was when las' 
"ended". 



DESCRIPTION 

The [timing] softkey display on the CRT will vary with the hardware configuration of the system. If 
an emulator, state analyzer, or software performance analyzer is installed in the system, along with 
the timing analyzer hardware, the softkey display will be [meassys] . Issuing the 
"measurement_system" command will allow the user to select (by way of a new softkey configura- 
tion) either emulation, state analysis, or timing analysis for system operation. 

Refer to the Timing Analyzer Reference Manual for a detailed description. 
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userid 



SYNTAX 



userid <USERID> [listfile default <list destination^ 

[password <PASSW0RD>*] 
*not printed 



Default Values 



<USERID> 
<list destination 
<PASSWORD> 



If no userid is entered, the "blank userid" is assumed. 

If no listfile default is specified, the default is null. 

If no password is specified, the userid is not protected. 



Examples: 

userid Sets the userid to be blank and the listfile default to null. 

userid MAX listfile default printer 

Sets the userid to MAX and the listfile default to the printer. 

userid MAX password secret 

Sets userid to protected userid pMAX provided "secret" is the password or if 
this is the first time this password has been used, it sets a protected userid 
pMAX. 

FUNCTION 

Allows user to select current userid and where listings should be sent by default. 
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Parameters: 

<USERID> 

<list destination 

<PASSWORD> 



Name of userid to become current userid. 

File or device to which listing output is to be sent by default. 

Up to 15 characters including all ASCII characters (i.e., alphanumerics, 
punctuations, and control characters) except spaces. 



DESCRIPTION 

For purposes of file management, it is convenient to have userid associated with disc files. Since a 
user will most frequently be referencing files under his own userid, this command allows the user to 
specify his id which, thereafter, will automatically be assumed for all file references. When a userid is 
entered, if a source file named WELCOME exists under the new userid, the first 18 lines of file 
WELCOME are copied to the display. This feature allows users to display information or messages 
about their files. 

Protected userids are not accessible from any userid other than the protected userid itself. Protected 
userid files will be displayed with other files in directory commands with the "all_userid" specifier 
when issued from any userid; however, they may only be accessed after the default userid has been 
set to the protected userid. It should be noted that since the lower-case "p" precedes the specified 
userid name in a protected userid, only five (5) characters are significant in a protected userid name. 






CAUTION 



Once entered, the password on a protected userid can only be 
identified by the system manager (see Chapter 2 of this 
manual) and the user. The password may however, be changed 
while operating under that protected userid by re-entering 
the userid command and changing to a new password. 
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verify 



SYNTAX 









*verify 


<file group>[:<file type>][<date qualifier>] 
**file # <FILE #> with <FILE> [:<file type>] 




[list <list destination^*] 


*Appears only on systems with tape or floppy backup 
running from hard disc. 


**Appears only on systems with tape option. 



Default Values 



<file group> 
<file type> 
<date qualifier 



Defaults to files of any name with current userid. 

Defaults to all types. With a file # referenced file, the default is source. 

If no date qualifier is specified, dates are ignored and do not affect files 
compared. 



Examples: 

verify 

verify FILEA:source 



Compares with files on bus disc, all tape or floppy files with current 
userid of all types from all bus discs. 

Compares with file on bus disc, source file FILEA with current userid on 
tape or floppy from all bus discs. 
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verify file #2 with FILEB 



Compares the second file on tape or floppy with FILEB type source with 
current userid on any bus disc. 



FUNCTION 

Allows user to verify that a file on bus disc is the same as a file on tape or floppy. Allows the user to 
verify that data stored on "DC600" tape is readable. 



Parameters: 

<file group> 
<file type> 
<date qualifier 

<FILE #> 

<list destination> 



Specifies a file or group of files to be verified. 

Type of file to be verified. 

Allows verification of files selectively based on date of last modification 
or access. 

Sequence number of file as stored on tape. 

Specifies file or device to receive listing output. 



DESCRIPTION 

The verify command accomplishes two things: 1) It verifies that the tape or floppy is readable. 2) It 
verifies the data stored on the tape or floppy against the data stored on the bus disc. 

If a "low threshold" message is present during a verify operation, the information on the tape is of 
marginal quality. An effort should be made to regenerate the tape. 
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SOFTWARE UPDATE PROCEDURES 



SOFTWARE LOADING AND UPDATING PROCEDURE 
USING FLEXIBLE DISC DRIVE 



This procedure should be used to load or update system software after user-generated files 
have been stored on the bus disc. To initialize, perform performance verification, or fix soft 
data errors on the bus disc, refer to the Service Overview Manual. 



Procedure: 



NOTE 

In a cluster 64000 installation, this procedure must be run on 
the master controller; all other stations should be powered 
off. 



a. Set System Control Source switches to "LOCAL MASS STORAGE", "(LMS) 
ADRSABLE", or "(LMS) TALK ONLY. 



b. Check software to be booted. If it does not include OP SYSTEM 1 of flexible 

disc, insert original OP SYSTEM #1 disc into flexible disc drive. 



NOTE 

When loading or updating software from a flexible disc(s), 
flexible disc OP System #1 must be loaded first. Additional 
discs should then be loaded in numerical order 



c. With development station power on, hold ( SHIFT") key down and press ( RESET ) 
key once. Disc light should come on and display should indicate BOOT IN 
PROGRESS; if not, cycle station power OFF and then back ON. When the SYSTEM 
#1 flexible disc is booted, the soft keys appear as follows: 
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]!°[[D§D Gestj CfmtSJstj Csoft fixj C^iagj C^enuj f _j C?n3j 



Press Cendj and continue. 

d. Insert other flexible disc in disc drive; disc should begin booting automatically and 
BOOT IN PROGRESS message should appear on the CRT. (Repeat this for each 
additional disc.) 

e. When ail flexible disc loading is complete, remove disc and reset system Control 
Source Switches to SYSTEM BUS; normal operation is now automatically resumed. 



NOTE 

For format, test, soft fix, and diagnostic options, refer to the 
System Diagnostic Manual. 



SOFTWARE LOADING AND UPDATING PROCEDURE 
USING TAPE CARTRIDGE 

NOTE 

The following procedure is for users that have older Model 
64000s with tape cartridge drive capabilities. This capability 
is no longer supported on the later models. 

This procedure should be used to load or update system software after user-generated files 
have been stored on the bus disc. To initialize, perform performance verification, or fix soft 
data errors on the disc, refer to the Installation and Configuration Manual. 



Procedure; 



NOTE 

In a 64000 cluster installation, this procedure must be run on 
the master controller; all other stations should be powered 
off. 
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a. Set System Control Source switches to "LOCAL MASS STORAGE", "(LMS) 
ADRSABLE", or "(LMS) TALK ONLY". 

b. Check software to be booted. If it includes an Operating System #1 tape, do NOT 
boot tape #1 as it is used only for disc reformatting, performance verification, and 
soft data error correction. If this tape is booted accidentally the softkeys appear 
as follows: 



CfocrnaD CJesJj C!rnJ?!§?J Csoft fjxj C^jag j Cmenuj r _j Tench 

Just press C?n§J and continue by inserting another tape. 



c. Insert Operating System (or other) tape in front -panel tape drive slot of the mast- 
er controller station. 

d. With development system power on, hold ( SHIFT") key down and press Q 3ES1TH 
key once. Tape light should come on and display should indicate BOOT IN 
PROGRESS: if not, cycle station power OFF and then back ON. 

e. Insert other tape (if provided) in tape drive; tape should begin booting automatical- 
ly and BOOT IN PROGRESS message should appear on the CRT. (Repeat this step 
for each additional tape.) 

f. When all tape loading is complete, remove tape cartridge and reset System Control 
Source Switches to SYSTEM BUS; normal operation is now automatically resumed. 



NOTE 

For format, test, soft fix, or diagnostic options, refer to the 
System Diagnostic Manual. 
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NOTES 
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Appendix A 



STATUS AND ERROR MESSAGES 



This appendix may be used as a quick reference guide for general status/error messages 
associated with the system monitor. These messages are not all inclusive. For status/error 
messages associated with a specific system module (i.e., editor, linker, assembler, etc.) refer 
to the applicable module reference manual. 

The monitor status/error messages are listed alphabetically in two separate tables for con- 
venience of the user. 



Table A-l. General Status Messages 



Status Messages 



Meaning 



Awaiting command userid: XXXXXX 

CAPS LOCK off 

CAPS LOCK on 

Cartridge tension complete 

Commands to file FILE until "log off" 

Copying 

Copy complete, N records transferred 

Copy complete, N records transferred 
(rs232 timed out) 

End of directory, N files listed 

Fri, 27 Feb, 1 1:40 (example) 



System is ready for commands and 
the default userid is XXXXXX. 

All alphabetic keys default to lower 
case. 

All alphabetic keys default to upper 
case. 

Tensioning tape finished. 

Log commands activated to file. 

One file is being copied to another. 

Copy using RS-232-C complete. 

Copy using RS-232-C ended by time 
out on received data. 

Directory is complete. 

Date or time command has displayed 
current system date and time. 
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Status Messages 



Meaning 



INSERT CHAR off 



Normal noninserting operation 

resumed. 



INSERT CHAR on 



I/O Bus reset 



Characters typed will be inserted at 
special O cursor. 

The master controller station displays 
this message when it has had to gain 
access to a network resource. 



I/O Bus wait 



The 64000 station displaying this 
message is waiting for a network 
resource. 



Listing files 

Listing recoverable files 



Directory is listing files to listfile. 

Directory is listing recoverable files to 
listfile. 



No action taken 



Log or command copy was aborted by 
user's choice not to purge existing 
file. 



PAUSED (to initiate RESET, press 
RESET again) 



Premarking directory 



Reading directory 



Recall buffer empty 



Receiving record N 



Restore complete, files restored=N of 
M 



Rewinding 



The RESET key has been pressed 
once. Pressing any other key resumes 
normal operation. 

Store command is premarking selected 
directory. 

Selected command is reading media 
directory. 

No valid commands have been issued 
since boot-up. 

Record N of a file is received over 
RS-232-C via copy. 

N of the M files meeting the qualifica- 
tions given have been restored (for 
reason others were not restored, see 
listing). 

Tape cartridge is being rewound. 
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Table A-l. General Status Messages (Cont'd) 



Status Messages 



Meaning 



Searching 

Searching for files 

Searching for recoverable files 

Searching for userids 

Store complete, files stored = N of M 



Storing FILE 
Tensioning tape 
Transmitting record N 

Verify complete, files verified = N of M 



Verifying FILE 
Waiting for data 
Waiting for input 
Waiting for printer 

Writing directory 



Restore or verify is finding file on 
storage media. 

Directory is searching disc for files. 

Directory is reading recoverable file 
list. 

Directory is scanning disc for all 
userids. 

N of the M files meeting the qualifica- 
tions given have been stored (for 
reason others were not stored, see 
listing). 

File is being written to storage media. 

Tension command is tensioning tape. 

Record N of a file is being transmitted 
out over RS-232-C via copy. 

N of the M files meeting the qualifica- 
tions given have been verified (for 
reason others were not verified, see 
listing). 

File on storage media is being com- 
pared to disc. 

Copy from RS-232-C is waiting for 
data to be received. 

Restore is waiting for response to 
question. 

The station displaying this message is 
waiting for another station which is 
using the printer. 

Station command is updating storage 
media directory. 
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Table A -2. General Error Messages 



Error Messages 

Cartridge out 

Device timeout 



Directory full: 
file=FILE:type 

Disc full - file=FILE:type 



Meaning 

No data cartridge was 
detected following a 
tape command. 

Storage media drive did 
not respond within cor- 
rect interval. 



File cannot be created 
directory full. 

Disc is too full to work 
with named file. 



Corrective Action 

Insert data cartridge and reis- 
sue command. 



Check all cable connections to 
media drive and media control 
board. If problem continues, 
contact HP Service 

Representative. 

Purge unwanted files. 



Purge unwanted files. 



Disc N down 



Disc with LU N is in one 
of the following states: 

Power off: Drive fault; 
Heads not loaded; Busy; 
Read has timed out. 



Check disc LU N for error 

indications. 



Disc number is invalid 



End of file: 
file=FILE:type 

File exists: 

file=FILE:type 



An attempt was made 
to read the directory on 
a disc whose LU was 
not defined at 

power-up. 

Premature end of file 
was encountered. 

This error implies at- 
tempt to create file by 
same name. 



If the disc was attached after 
power-up, reboot the system; 
otherwise, correct the com- 
mand to a valid LU. 



Regenerate file in question. 



Purge file, if unwanted, or cre- 
ate a new file. 



File may not be ap- 
pended to itself 



A library command has 
same file as source and 

destination. 



Revise command to use two 
distinct file names. 



File name:HP not 
present 



System software by 
this name is not on disc 
LU 0. 



Boot from approriate system 
software media. 
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Table A -2. General Error Messages (Cont'd) 



Error Messages 

File not found 



Meaning 

A file in the issued file 
management command 
does not exist. 



Corrective Action 

Correct to an existing file name. 



File too big for tape, 
split file into 2 pieces 



Framing error 



File with data length 
greater than tape 
capacity cannot be 
stored as a single file. 

During copy from 
RS-232, one of the fol- 
lowing errors has 
occurred: 



Modify file so it will fit (probab- 
ly by splitting a source or by 
listing in half). 



Check for consistency in setup 
of RS232 transmitter and 
receiver. 



Illegal directory or tape 
format 



Rec/trans baud rates 
are different; Parity 
error; Character 

length; Number of 
stop bits wrong. 

The data cartridge 
being read was created 
on another system 
which did one of the 
following: 

1. Did not adhere to 
Standard Interchange 
Format (SIF) used by 
64000 system tape 
software. 



The information is obtainable 
from tape only if the tape is in 
SIF format. To avoid an incom- 
patible directory format, files 
must be referenced by file num- 
ber (see restore and verify 
command syntax. 



Illegal disc: 

file=FILE:type 

Invalid date 



2. Used no directory or 
directory format dif- 
ferent from that of the 
64000 tapes. 

There is no disc with LU 
# on this file. 

An illegal date has been 
specified. 



Attach appropriate disc, 
reference proper LU #. 



or 



Revise date per Day/Mon/Year 
format. 
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Error Messages 

Invalid disc number 



Invalid input, question 
must be answered 



Invalid time 



Invalid to recover 
across discs 



Meaning 

A disc LU number not 
assigned was used. 

A nonreproducible file 
which already exists is 
about to be overwritten 
and user permission is 
being requested. 

An illegal time has been 
specified. 

A recovery has been 
attempted from one LU 
to another. 



Corrective Action 

Revise LU number to one cur- 
rently assigned. 

Answer question: "yes" - I do 
mean to overwrite the file; or 
"no" - I do not want the file 
overwritten. 



Revise time per HH:MM format. 



Revise command to use only 
one LU. 



Invalid to rename 
across discs 



A name has been at- 
tempted from one LU to 
another. 



Revise command to use only 

one LU. 



"log commands" not A "log commands" 

permitted in command command was in 
file cmdfile. 



Remove "log commands" from 

command file. 



Maximum parameter 

name size exceeded 



During read of PARMS 
statement in a command 
file, the maximum num- 
ber of characters in pa- 
rameter name was 
exceeded. 



Use shorter or fewer parameter 

names. 



Maximum parameter 

text length exceeded 



The absolute maximum 
length of text to be 
substituted for cmdfile 
parameters has been 
exceeded. 



Shorten number of ASCII 
characters in text being passed 
to cmdfile parameters. 



More parameters 

passed than declared 



Parameter &NAME not 
found 



During invocation of 
command file, text for 
more parameters than 
declared was passed. 

During execution of a 
command file, an un- 
declared parameter 
was found 



Declare additional parameter or 
correct text passed. 



Examine command file and 
corect parameter name or 
declaration. 



A-6 



System Software 
Reference Manual 



Table A -2. General Error Messages (Cont'd) 



Error Messages 

Printer down 

Powerfail or bus reset 



Recovered 



Meaning 

Printer is powered off 
or is off line. 

During tape or floppy 
operation, a power 
failure or bus reset oc- 
curred, aborting the 
operation. 

System has recovered 
from one of the last 
three conditions. 



Corrective Action 

Check printer. 



Repeat the 

operation. 



attempted 



None. 



Retrying disc N 



One of the following 
has occurred accessing 
disc LU N: 

Seek check; Head just 
reloaded; Transmission 
error; Cylinder, Head, 
Track compare error; 
Data error; Illegal track 
access; Head off track; 
Write to protected 
track. 



Wait for retry-in to recover it- 
self. If it does not, reboot sys- 
tem and disc. If trouble con- 
tinues, call HP Service 
Representative. 



Servo Failure 



Syntax error 



Syntax error S1 



A servo failure in the 
storage media drive 
was detected. 



Command just issued 
has a syntax error at 
the point where cursor 
is located. 

The system has run out 
of available memory. 



Check all cable connections to 
media drive and media control 
board. If problem continues, 
contact HP Service 

Representative. 

The softkeys are labelled to in- 
dicate the valid syntax at the 
cursor position; modify com- 
mand to reflect a valid choice. 

Reboot; if problem occurs 
frequently, call HP Service 
Representative. 
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Error Messages Meanings Corrective Action 

Tape cartridge No tape control board Check connection or tape con- 
hardware not present was detected in the trol board, if present. Issue 

card cage of station on command on station with tape 

which a tape command hardware, 
was given. 

Tape's directory is An attempt was made Tape is empty and should now 

empty to read the directory of be accessed only by a store 

a tape which is command. 

premarked but has no 

files stored on it. 

Write protected A command requesting To write to the media, remove 

a write of data to the the write inhibit tab. 
storage media was is- 
sued and the write 
protect tab is in the 
protect position. 
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The following index lists important terms and concepts of this manual along with location(s) in which 
they can be found. The numbers to the right of the listings indicate the following manual areas: 



• Chapters 

• Appendixes 

• Figures 

• Other entries 



- references to chapters appear as "Chapter X", where "X" represents the chap- 

ter number. 

- references to appendixes appear as "Appdx Y", where "Y" represents the let- 

ter designator of the appendix. 

- references to figures are represented by the capital letter "F" followed by the 
figure number. 

- reference to other entries in the index are by page number. 
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a 



absolute file type 2-1 

accessing protected files 2-3 

append Syntax 3-14 

append 2-5 

asmb_db file type 2-1 

asmbsym file type 2-1 

assemble Syntax 3-16 

assigning file manager password 2-3 

attributes of a file 3-7 

AutoCmd_# 1-10 

automatic command file execution 1-10 



-BACKUP- 3-3 

building command files 1-6,1-9 

bus disc files 3-27 



calendar dates, initializing in operating system 2-3 

changing file names (renaming files) 3-46 

changing userid passwords 2-3 

clock 

setting system date and time 3-24 

<CMDFILE> Syntax 3-18 

<CMDFILE> 2-5 

combining relocatable code into a library 2-4 

command area, display 1-1 

Command Files 1-6 

AutoCmd_# 1-10 

automatic command file execution 1-10 

logging command to a command file 1-9 

syntax 3-18 

Command File Structure 1-7 

command structure 1-6 
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Commands: 

Editing 1-4 

Entering 1-3 

Logging 1-9 

Recalling 1-4 

Re-executing 1-4 

Stopping Execution 1-5 

communicating with a host computer 3-58 

comp_db file type 2-1 

comp_sym file type 2-1 

comparing bus disc file with floppy disc file 3-63 

compile Syntax 3-20 

constants, specifying numeric 1-3 

copy Syntax 3-22 

copy 2-5 

copying bus disc files to floppy or tape 3-55 

copying files 3-22 

copying floppy files to bus disc 3-47 

cursor 1-1 



data file type 2-1 

<DATE> Syntax 3-5 

<date qualifier> Syntax 3-6 

date&time Syntax 3-24 

date 2-5 

selecting files by access date 3-6 

setting system date and time 3-24 

directory Syntax 3-26 

directed syntax 1-2 

--BACKUP— 3-3 

...ETC— 1-2 

lower-case characters 3-4 

softkey label line 3-1 

softkey levels 3-1 

softkey variation with hardware 3-1 

upper-case characters 3-4 

directory 2-5 

Directory Format 2-4 

directory organization 2-4 

disabling remote control 3-50 

display 1-1 

command area display 1-1 

cursor 1-1 

STATUS line 1-1 

Display Format F1-1(pg 1-2) 
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edit Syntax 3-29 

edit, recovering previous versions of an edited file 2-3 

emulate Syntax 3-31 

emulcom file type 2-2 

enabling remote control 3-50 

enterng commands 1-3 

keywords 1-3 

lower-case characters 3-4 

upper-case characters 3-4 

error messages Appdx A 

...ETC— 1-2 

executing command file automatically at power-up 1-10 

executing commands 1-3,1-4,1-5 

executing terminal mode software 3-57 



<FILE> Syntax 3-7 

<file group> Syntax 3-9 

<file type> Syntax 3-10 

files, definition 2-1 

Files, type 2-1 

File Manager 2-2 

file management 2-1,2-2 

assigning file manager password 2-3 

file management commands 2-5 

file security 2-3 

user passwords 2-3 

userid 2-3,3-12, 3-61 

file naming conventions 2-1 

File Security 2-3 

file system structure 2-4 

Flexible Disc Utility 4-1 

floppy Syntax 3-33 

floppy utilities monitor 3-33 

floppy system generator monitor 3-33 



generate_database 3-34 
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initializing operating system calendar dates 3-24 

input and output via RS-232 3-23 



keywords 1-3 



library Syntax 3-36 

library 2-5 

Libraries, user 2-4, 3-36 

link Syntax 3-37 

linkcom file type 2-2 

link_sym file type 2-2 

<list destination Syntax 3-11 

listing bus disc files 3-26 

listing file type 2-2 

listing userid passwords 2-3 

loading system software 4-1 

log, defined 2-5 

logcommands Syntax 3-39 

logging commands to a command file 1-9 

lower-case character, use 3-4 



m 



meassys 3-40 

measurementsys Syntax 3-40 

Messages 

Error Appdx A 

Status Appdx A 

moving files 3-23 
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n 



numeric constants 1-3 



opt_test 3-41 

option_test Syntax 3-41 

organizing files 2-2 

output 

selecting files or devices for output listing 3-11 

via RS-232 3-23 



Page Structure 2-4 

Parameter passing 1-6 

passwords 2-3 

recovering lost passwords 2-3 

userid 3-12,3-61 

pMgR 2-3 

Predefined Syntax Elements 

<DATE> 3-5 

<date qualifier 3-6 

<FILE> 3-7 

<file group> 3-9 

<file type> 3-10 

<list destination> 3-11 

<USERID> 3-12 

prom file type 2-2 

prom programmer Syntax 3-42 

protecting files 2-3 

purge Syntax 3-43 

purge 2-5 

purging files 2-3 

recovering purged files 3-44 



RECALL 1-4 

recover Syntax 3-44 

recover 2-5 
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recoverable files list 2-3 

recovering lost passwords 2-3 

recovering previous versions of edited files 2-3,3-44 

recovering purged files 2-3, 3-44 

referencing files of another userid 3-12 

reloc file type 2-2 

relocatable code 

combining relocatables into a library 2-4 

remote control 

disabling remote control 3-50 

enabling remote control 3-50 

removing files 3-43 

rename Syntax 3-46 

rename 2-5 

renaming files 3-46 

restore Syntax 3-47 

restore 2-5 

run Syntax 3-51 

RS-232 

input and output via RS-232 3-23 



searching for files with wild card 3-9 

selecting files by access date 3-6 

selecting files or devices for output listing 3-11 

selecting groups of files by using wild cards 3-9 

setting system date and time 3-24 

SHIFT RECALL 1-4 

softkeys 1-2 

label line 3-1 

levels 3-1 

variation with hardware 3-1 

Software Loading 

Flexible Disc 4-1 

Tape 4-2 

specifying numeric constants 1-3 

state Syntax 3-53 

state analysis 3-53 

STATUS line 1-1 

Status Messages Appdx A 

store Syntax 3-55 

store 2-5 

subsystem monitors 3-1 

System file type 2-2 

System monitor 3-1 

System software 
updating 4-1 
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TAPE Utility 4-2 

terminal Syntax 3-58 

lime Syntax 3-58 

setting system time 3-24 

timing analysis 3-59 

trace file type 2-2 

translating source code inputs into relocatable modules 3-17 



u 



uniform syntax/feature set 1-3 

upper case command line elements 3-4 

userid Syntax 3-61 

defined 2-5 

passwords 2-3 

referencing files of another userid 3-12 

<USERID> Syntax 3-12 

using libraries 2-4 



verify Syntax 3-63 

verify 

compare bus disc file with floppy file 3-63 

defined 2-5 

verifying performance of optional boards 3-41 



w 



wildcard 
selecting groups of files 3-9 
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